
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of XYMOND_CAPTURE</TITLE>
</HEAD><BODY>
<H1>XYMOND_CAPTURE</H1>
Section: Maintenance Commands (8)<BR>Updated: Version 4.3.13:  7 Jan 2014<BR><A HREF="#index">Index</A>
<A HREF="../index.html">Return to Main Contents</A><HR>

<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>

xymond_capture - catch selected messages from a xymond channel
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>

<B>xymond_channel --channel=status xymond_capture [options]</B>

<P>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>

xymond_capture is a worker module for xymond, and as such it is normally
run via the
<I><A HREF="../man8/xymond_channel.8.html">xymond_channel</A>(8)</I>

program. It receives messages from xymond via stdin and filters them to
select messages based on the hostname, testname or color of the status.
By default the resulting messages are printed on stdout, but they can also
be fed into a command for further processing.
<P>
xymond_capture supports the <B>status</B>, <B>data</B>, <B>client</B> and 
<B>hostdata</B> channels.
<P>
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>

<DL COMPACT>
<DT>--hosts=PATTERN<DD>
Select messages only from hosts matching PATTERN (regular expression).
<P>
<DT>--exhosts=PATTERN<DD>
Exclude messages from hosts matching PATTERN. If used with the --hosts option, 
then the hostname must match the --hosts pattern, but NOT the --exhosts pattern.
<P>
<DT>--tests=PATTERN<DD>
Select messages only from tests matching PATTERN (regular expression).
<P>
<DT>--extests=PATTERN<DD>
Exclude messages from tests matching PATTERN. If used with the --tests option, 
then the testname must match the --tests pattern, but NOT the --extests pattern.
<P>
<DT>--colors=COLOR[,color]<DD>
Select messages based on the color of the status message. Multiple colors can be 
listed, separated by comma. Default: Accept all colors.
<P>
<DT>--batch-command=COMMAND<DD>
Instead of printing the messages to stdout, feed them to COMMAND on stdin. COMMAND
can be any command which accepts the mssage on standard input.
<P>
<DT>--batch-timeout=SECONDS<DD>
Collect messages until no messages have arrived in SECONDS seconds, before sending
them to the --batch-command COMMAND.
<P>
<DT>--client<DD>
Capture data from the &quot;client&quot; channel instead of the default &quot;status&quot; channel.
<P>
<DT>--debug<DD>
Enable debugging output.
<P>
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>SEE ALSO</H2>

<A HREF="../man8/xymond_channel.8.html">xymond_channel</A>(8), <A HREF="../man8/xymond.8.html">xymond</A>(8), <A HREF="../man7/xymon.7.html">xymon</A>(7)
<P>
<P>

<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT><A HREF="#lbAB">NAME</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT><A HREF="#lbAE">OPTIONS</A><DD>
<DT><A HREF="#lbAF">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 09:25:35 GMT, January 07, 2014
</BODY>
</HTML>
